home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 201-220 / scopedisk214 / req / req.doc < prev    next >
Text File  |  1995-03-19  |  4KB  |  89 lines
  1. Req, The file requester shell.
  2.  
  3.     © 1991 Arnie Cachelin, HyperActive InterMedia
  4.  
  5. Req lets you easily load files into any dos command or script using 
  6. the Workbench 2.x file requester.  Req can be used with a single 
  7. command from the Shell or a script, or with multiple commands from the 
  8. Workbench -- just enter it into the Req icon's ToolTypes array.  Req 
  9. works only under Workbench 2.x.
  10.  
  11. So What?
  12.  
  13. This means creating and editing simple scripts without a text 
  14. editor.  This means easy file requester access for countless utilities 
  15. like sound players and un-arcers (see the examples in the included 
  16. icon).  This means icon launched scripts which are self-contained, and 
  17. don't care where iconx is. 
  18.  
  19. Setting The Commands
  20.  
  21. To set the program icon's tooltypes, click on the icon, then 
  22. select 'Information' in the Workbench/Icons menu.  When the info 
  23. window comes up, click on the tooltype entry in the list to edit that 
  24. entry, or select 'New' to add an entry.  When the entry is complete, 
  25. hit return to place it in the list, and click the save button to exit.  
  26. Now double-click on the Req icon, and you will see the Req file 
  27. requester appear on your Workbench screen.  Now select a file, and the 
  28. command(s) you entered will be executed using the file you picked.  
  29. Note that the first command will appear in the requester title.  If 
  30. you are satisfied with the performance, you should duplicate Req, and 
  31. rename it in a way which makes its function apparent.
  32.  
  33. Entries should be valid commands, and appear as they would be 
  34. typed in a CLI window, with the full path of the command specified.  
  35. The path and the name of the selected file will be substituted into 
  36. successive occurances of "%s" in the command entry.  (i.e. if the file 
  37. MyDisk:CoolPic is processed with the command entry 'C:Show "%s%s"', 
  38. the first %s will be replaced with 'MyDisk:' and the second, by 
  39. 'CoolPic'.)  Quotes (") around the file/path symbols are not required 
  40. by Req, but will allow file names which contain spaces to be processed 
  41. in most cases. 
  42.  
  43. Req sends a command's output to a default output window, unless a 
  44. custom window specification is included.  If you don't want a window 
  45. to appear, use WINDOW=NIL: in the tooltypes array.  If you don't want 
  46. that tooltype executed as if it were a command, use a blank line 
  47. tooltype to separate 'WINDOW=' entry from the last command entry.  
  48. This window snaps shut immediately after the command finishes.
  49.  
  50. Req also works when run with a command string from the CLI.  It 
  51. is particularly fun to use it in an alias in the s:Shell-Startup file 
  52. which will give your favorite commands a file requester (i.e. ALIAS 
  53. Pic req "C:show %s%s").  Req will also take a file name to launch the 
  54. requester with as an optional third argument.
  55.  
  56. C Programmers
  57.  
  58. Source code for Req is included.  It is a quite simple program  I 
  59. should also try to use AmigaDOS 2.0 Makelink command rather than 
  60. duplicating the file for different icons.
  61.  
  62. I really like this little program, and am glad WB 2.0 makes it so 
  63. easy to do.  I also feel kinda object-oriented when I can encapsulate 
  64. all the program's configuration data in its icon.  I hope you find 
  65. this useful and interesting.  My inspiration for this program is Eric 
  66. Schwertfeger's excellent MicroBrowser utility, which uses the arp file 
  67. requester.
  68.  
  69.  Req is freely distributable shareware, please send whatever 
  70. contribution you consider appropriate.
  71.  
  72.  
  73.  
  74. Please send suggestions, bug reports, updates, jobs, candygrams, etc. 
  75. to:
  76.  
  77.  
  78.  
  79. Arnie Cachelin
  80.  
  81. 1743 Hayes St.
  82.  
  83. San Francisco, CA 94117
  84.  
  85.  
  86.  
  87.  
  88.  
  89.